home *** CD-ROM | disk | FTP | other *** search
/ NASA Climatology Interdisciplinary Data Collection / NASA Climatology Interdisciplinary Data Collection - Disc 4.iso / software / grads / lib / sample2.gui < prev    next >
Encoding:
Text File  |  1998-04-23  |  10.7 KB  |  232 lines
  1. #  sample2.gui - last revision: October 12, 1997
  2. #
  3. #  Sample widget script with tutorial comments. Modify it for
  4. #  your own taste and needs. Simplified version of "sample.gui".
  5. #
  6. #  How to invoke this script:
  7. #
  8. #  At startup. Set the enviroment variable GAGUI with the
  9. #  name of the script file, e.g., 
  10. #
  11. #  % setenv GAGUI sample.gui
  12. #
  13. #  At the GrADS command line prompt. Simply type
  14. #
  15. #  ga> gui sample.gui
  16. #
  17. #  Of course, you must have a version of GrADS built with
  18. #  Athena Widgets support.
  19. #
  20. #  --
  21. #   (c) 1997 by Arlindo da Silva
  22. #
  23. #   Permission is granted to any individual or institution to use,
  24. #   copy, or redistribute this software so long as it is not sold for
  25. #   profit, and provided this notice is retained. 
  26. #
  27. #  See also sample.gui, window.gui.
  28. #.........................................................................
  29.  
  30.  
  31. #  Most "exec" commands are supported
  32. #  ----------------------------------
  33.    set gxout shaded
  34.  
  35. # This command creates a dropdown menu called " File ";
  36. # as usual, the first argument "file" is the name of the
  37. # widget
  38. # -------------------------------------------------------
  39.   MakeMenu ( file, "File" )
  40.  
  41. # Once you make a memu, you create its items. For the first item:
  42. # --------------------------------------------------------------
  43.       MakeMenuItem(open,  file, "Open",             Load,    "open")
  44.  
  45. # The parameters this particular item are:
  46. #     open    the name of the item widget
  47. #     file    the menu the item belongs to (see MakeMenu above)
  48. #     "Open"  This is the text it displays on the screen
  49. #     Load    this is the callback name, i.e., the widget invokes
  50. #             this function when pressed. This particular callback
  51. #             pops up a "file finder" widget, and after the user
  52. #             clicks on a file name it executes the grads command
  53. #             "open" (see last argument) on this file. A list
  54. #             of the other available callbacks can be found in the
  55. #             end of this file.
  56. #     "open"  Argument to be passed to the callback. In this 
  57. #             particular case, it is the GrADS command to be
  58. #             executed on the file.
  59. #  The definition of the other items in this menu follows.
  60.       MakeMenuItem(sdf,   file, "SDF Open",         Load,    "sdfopen")
  61.       MakeMenuItem(xdf,   file, "XDF Open",         Load,    "xdfopen")
  62.       MakeMenuItem(fsel,  file, "File Selection ",  FileSel, NULL )
  63.       MakeMenuItem(browse,file, "View Text File",   Browse,  NULL)
  64.       MakeMenuItem(junk,  file, "_______________",  NULL,    NULL )
  65.       MakeMenuItem(exec,  file, "Exec",             Load,    "exec")
  66.       MakeMenuItem(run,   file, "Run",              Load,    "run")
  67.       MakeMenuItem(gui,   file, "GUI",              Load,    "gui")
  68.       MakeMenuItem(junk,  file, "_______________",  NULL,    NULL )
  69.       MakeMenuItem(fresh, file, "Refresh",          Cmd,     "  ")
  70.       MakeMenuItem(init,  file, "Reinit",           Cmd,     "reinit")
  71.       MakeMenuItem(exit,  file, "Exit",             Cmd,     "quit")
  72.  
  73. # A menu for gx metafile printing related commands
  74. # ------------------------------------------------
  75.   MakeMenu ( print, "Print" )
  76.       MakeMenuItem(printit, print, "Print",         Cmd,   "print")
  77.       MakeMenuItem(enable,  print, "Enable  Print", Load,  "enable print")
  78.       MakeMenuItem(disable, print, "Disable Print", Cmd,   "disable print")
  79.  
  80. # A menu with assorted internal options
  81. # -------------------------------------
  82.   MakeMenu ( options, "Options" )
  83.       MakeMenuItem(shade,  options, "Shaded",      Cmd, "set gxout shaded" )
  84.       MakeMenuItem(cont,   options, "Contour",     Cmd, "set gxout contour" )
  85.       MakeMenuItem(grfill, options, "Grid Fill",   Cmd, "set gxout grfill" )
  86.       MakeMenuItem(grvals, options, "Grid Values", Cmd, "set gxout grid" )
  87.       MakeMenuItem(vec,    options, "Vector",      Cmd, "set gxout vector" )
  88.       MakeMenuItem(strm,   options, "Streamlines", Cmd, "set gxout stream" )
  89.       MakeMenuItem(bar,    options, "Bar Chart",   Cmd, "set gxout bar" )
  90.       MakeMenuItem(line,   options, "Line Plot",   Cmd, "set gxout line" )
  91.       MakeMenuItem(barb,   options, "Wind Barbs",  Cmd, "set gxout  barb" )
  92.       MakeMenuItem(junk,   options, "_______________",  NULL, NULL )
  93.       MakeMenuItem(ci,     options, "Contour Interval",  CmdStr, "set cint" )
  94.       MakeMenuItem(tit,    options, "Draw Title", CmdStr, "draw title " )
  95.       MakeMenuItem(cbar,   options, "Color Bar",  Cmd, "run cbarn" )
  96.  
  97.  
  98. # Creates simple buttons. Buttons work pretty much like menu items
  99. # but they do not belong to any menu and are directly clickable.
  100. # ------------------------------------------------------------------
  101.   MakeButton( clear,  "Clear",      Cmd,      "clear" )
  102.   MakeButton( quit,   "Quit",       Cmd,      "quit" )
  103.   MakeButton( prompt, "ga>",  CmdWin,  NULL )
  104.  
  105. # A menu for defining GrADS dimensions. This is very crude right now.
  106. # I will be developing a specific callback with rubber bands
  107. # etc. for these functions. Stay tuned. 
  108. # ------------------------------------------------------------------
  109.   MakeMenu( dim, "Dim")
  110.       MakeMenuItem(lat,  dim, "Latitude",  CmdStr, "set lat " )
  111.       MakeMenuItem(lon,  dim, "Longitude", CmdStr, "set lon " )
  112.       MakeMenuItem(lev,  dim, "Level",     CmdStr, "set lev " )
  113.       MakeMenuItem(time, dim, "Time",      CmdStr, "set time " )
  114.       MakeMenuItem(junk, dim, "_________", NULL,   NULL )
  115.       MakeMenuItem(x,    dim, "x",         CmdStr, "set x " )
  116.       MakeMenuItem(y,    dim, "y",         CmdStr, "set y " )
  117.       MakeMenuItem(z,    dim, "z",         CmdStr, "set z " )
  118.       MakeMenuItem(t,    dim, "t",         CmdStr, "set t " )
  119.  
  120. # Frequently used buttons (and toggle)
  121. # -----------------------------------
  122.   MakeButton( var,  "Var",    VarSel,  NULL )
  123.   MakeToggle( hold, "Hold",   FALSE,  NULL, Toggle,  "hold" )
  124.   MakeButton( prev, " << ",   Display, "<<" )
  125.   MakeButton( play, "Display",   Display, "DISPLAY" )
  126.   MakeButton( next, " >> ",   Display, ">>" )
  127.   MakeButton( rein, "Reinit", Cmd,     "reinit")
  128.  
  129. # Once you define buttons and menus you may want to enforce their
  130. # relative position. The very first button is always placed at the
  131. # upper lefthand corner.
  132. # ----------------------------------------------------------------
  133.   SetWidgetPos(print,   NO_CARE, NULL, PLACE_RIGHT, file )
  134.   SetWidgetPos(options, NO_CARE, NULL, PLACE_RIGHT, print )
  135.   SetWidgetPos(dim,     NO_CARE, NULL, PLACE_RIGHT, options )
  136.   SetWidgetPos(prompt,  NO_CARE, NULL, PLACE_RIGHT, dim )
  137.   SetWidgetPos(hold,    NO_CARE, NULL, PLACE_RIGHT, prompt )
  138.   SetWidgetPos(var,     NO_CARE, NULL, PLACE_RIGHT, hold )
  139.   SetWidgetPos(prev,    NO_CARE, NULL, PLACE_RIGHT, var )
  140.   SetWidgetPos(play,    NO_CARE, NULL, PLACE_RIGHT, prev )
  141.   SetWidgetPos(next,    NO_CARE, NULL, PLACE_RIGHT, play )
  142.   SetWidgetPos(clear,   NO_CARE, NULL, PLACE_RIGHT, next )
  143.   SetWidgetPos(rein,    NO_CARE, NULL, PLACE_RIGHT, clear )
  144.   SetWidgetPos(quit,    NO_CARE, NULL, PLACE_RIGHT, rein )
  145.  
  146.  
  147. # You can optionally select a font for ALL widgets
  148. # ------------------------------------------------
  149. #  GetFont(font,"-*-helvetica-bold-o-normal--*-*-*-*-*-*-*-*" )
  150.    GetFont(font,"-*-helvetica-bold-o-normal--12-*-*-*-*-*-*-*" )
  151.    AllWidgetFont(font)
  152.  
  153. # In order to make your widgets appear on the screen you *must*
  154. # issue this command.
  155. # -------------------------------------------------------------
  156.   ShowDisplay()
  157.   
  158. # After your widgets appear on the screen, you can set the color 
  159. # of your widgets. The following colors are pre-defined:
  160. # white, back, red, green, blue, yellow.
  161. # --------------------------------------------------------------
  162.   GetNamedColor(gray,"grey")
  163.   GetNamedColor(Blue,"LightSkyBlue")
  164.   GetNamedColor(pink,"gold")         # pink is actually gold, get it?
  165.   AllFgColor(black)
  166.   AllBgColor(Blue)
  167.   SetBgColor(root,white)
  168.   SetFgColor(root,red)
  169.   SetFgColor(prompt,yellow)
  170.   SetBgColor(prompt,red)
  171.   SetBgColor(prev,pink)
  172.   SetBgColor(play,pink)
  173.   SetBgColor(next,pink)
  174.   SetBgColor(hold,gray)
  175.   SetBgColor(var,gray)
  176.   SetBgColor(clear,gray)
  177.   SetBgColor(rein,gray)
  178.   SetBgColor(quit,gray)
  179.  
  180.  
  181. # And you must call this function at the end of your first GUI script.
  182. # This instructs the X Toolkit to enter an infinite loop, monitoring
  183. # keyboard and mouse events. Repeating: you *must* call MainLoop().
  184. # -------------------------------------------------------------------
  185.   MainLoop()
  186.  
  187. #........................................................................
  188. #
  189. # APPENDIX: Currently available callback functions
  190. #
  191. #     Browse    Opens a text file, such as a help file, on a separate
  192. #               window.
  193. #     Cmd       Executes a generic GrADS command
  194. #     CmdStr    Like Cmd, but the user is prompted for an additional
  195. #               string to be appended to the GrADS command.
  196. #     CmdWin    Invokes a window for GrADS command line interface.
  197. #               User can click on past commands from a list.
  198. #     CmdLine   Invokes the standard GrADS command line interface.
  199. #               When the command line is active the other widgets
  200. #               are not available (may be fixed in the future).
  201. #     Display   A generic callback for displaying the current variale
  202. #               (or expression) set with VarSel. The options are:
  203. #                  <<    decrements time and executes display
  204. #                 PLAY   starts animation from current to last time
  205. #                DISPLAY just executes display
  206. #                  >>    increments time and  executes display
  207. #               If the "hold" toggle state is OFF (the default),
  208. #               the screen is cleared before displaying.
  209. #     Edit      Like browse, but the user can edit the file. This simple
  210. #               text editor is integrated with GrADS, providing a very
  211. #               elementary Integrated Development Enviroment (IDE) for
  212. #               GrADS scripts. In particular, the script being edited
  213. #               can be executed by clicling on a button.
  214. #     FileSel   Pops up a scrollable list and asks the user to selected
  215. #               a file among the currently opened GrADS files (including
  216. #               SDFs). The selected file becomes the default.
  217. #     Load      Pops up a "file finder" widget, and after the user
  218. #               clicks on a file name it executes a GrADS command
  219. #               specified as the last argument.
  220. #     Toggle    Turn internal options ON/OFF. The only internal
  221. #               option currently supported is "hold". This callback is
  222. #               usually used with MakeToggle(), see example above.
  223. #     VarSel    Pops up a scrollable list and asks the user to selected
  224. #               a variaable from the default file. The user can also
  225. #               type a generic GrADS expression instead of selecting
  226. #               a single variable.
  227. #     NULL      Does not do anything, used for inactive buttons.
  228. #
  229. #........................................................................
  230.  
  231.  
  232.